home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / misc / update / foxbrow.sit / About XBrowse2Click next >
Encoding:
Text File  |  1992-08-20  |  5.8 KB  |  164 lines
  1. /* XBrowse2Click version 1.0, 30-JUL-1992 ⌐1992 A.D. Software
  2.  
  3. THIS IS NOT FREE - see Shareware Details at end.
  4.  
  5. OVERVIEW
  6. XBrowse2Click provides two filters for solving problems with the
  7. user-interface of FoxBase+/mac.
  8. 1) the Browse filter allows you to convert double-clicking or hitting
  9.    the Tab, Enter or Return keys into a command-keystroke of your
  10.    choice (eg: command-O for Open). This enables you to double-click
  11.    Browse lines and go straight into editing a record.
  12.  
  13. 2) the Return filter simply converts Return characters to Tabs. This is
  14.    useful if you want to have the TAB and RETURN keys jump between fields
  15.    yet still have Enter terminate the READ and have looping back to the 
  16.    top field (ie: using SET STRICT ON). The problem with FoxBase is that
  17.    the Return key is usually treated the same as Enter.
  18.  
  19. DETAILS OF USING THE XFCN
  20.  
  21. THEORY
  22. The XFCN actually installs a separate piece of code for each of the filters,
  23. very much like the "inits" such as PopChar, screensavers etc. Therefore it is
  24. VERY important to Deactivate the current filter when you are finished.
  25.  
  26. The filters are aware when you "change application layers" under MultiFinder
  27. or System 7.
  28.  
  29. GENERAL USE OF XFCN'S
  30. XFCN's (and XCMDs) live in the current RESOURCE file, either your default
  31. FOXUSER file or a file that you've specified with a SET RESOURCE TO. They are
  32. loaded with the LOAD command (eg: LOAD XBrowse2Click FUNCTION). Note that the
  33. FUNCTION keyword is used as shown in this example for any XFCN's (to load an
  34. XCMD you just specify LOAD anXCMD).
  35.  
  36. The difference between XFCN and XCMD is that the XFCN returns a value, much
  37. like a UDF.
  38.  
  39. To call an XFCN you issue a CALL command which returns a value to the
  40. specified variable (creating it if doesn't already exist).
  41. eg: CALL XBrowse2Click TO res WITH "L"
  42.  
  43. Normally, you can reuse the memory of an XFCN with the RELEASE MODULE itsName
  44. command. However, this should NOT be applied to this XFCN - load it once,
  45. early, and leave it loaded (you don't have to release it if you are quitting
  46. your program as the quitting action cleans up the memory).
  47.  
  48. WARNING
  49. 1) It will cause all kind of weird errors if you LOAD the same XFCN twice
  50.    while running, without doing a RELEASE MODULE of the earlier LOAD.
  51.  
  52. 2) It is VERY important not to RELEASE MODULE this XFCN while a filter is 
  53.    active, as another load of the XFCN wouldn't know about the active filter.
  54.  
  55.  
  56. DETAILS OF USING XBrowse2Click
  57. In general, the return value is used to indicate success or the nature of an
  58. error. The first parameter is a "switch" to tell the XFCN which operation to
  59. perform.
  60.  
  61. The following descriptions show a sample usage of each call, with full details 
  62. of any additional parameters and the return value(s).
  63.  
  64.  
  65. LOADING THE FILTERS
  66. This step is performed ONCE for each run of your program.
  67.  
  68. CALL XBrowse2Click TO res WITH "L"
  69.  
  70. RETURN VALUES
  71.   0 = OK
  72.  -1 = invalid function switch
  73.  -2 = couldn't find one of the filters
  74.  
  75.  
  76. ACTIVATING THE BROWSE FILTER
  77.  
  78. OTHER PARAMETERS
  79.   2 - letter of the command key to send
  80.   3 - bitmask of what events are converted to a command-key
  81.         0 = double-click
  82.         1 = Enter key
  83.         2 = Return key
  84.         3 = Tab key
  85. eg: value of 15 = react to all four events
  86.     value of  3 = react to double-click and Enter but NOT Tab or Return
  87.  
  88. CALL XBrowse2Click TO res WITH "B", "O", 3
  89.  
  90. RETURN VALUES
  91.   0 = OK
  92.  -1 = invalid function switch
  93.  
  94.  
  95. ACTIVATING THE RETURN FILTER
  96. Every Return keystroke will be converted to a Tab, until you perform a 
  97. Deactivate. Note: this only applies to the plain Return key, pressed
  98. without any modifiers (eg: option-Return, shift-Return). You can therefore use
  99. option-Return within memo fields, the same as you can use option-Tab
  100.  
  101. CALL XBrowse2Click TO res WITH "R"
  102.  
  103. RETURN VALUES
  104.   0 = OK
  105.  -1 = invalid function switch
  106.  
  107. DEACTIVATING EITHER FILTER
  108. MUST be carried out before quitting FoxBase - simply stops the filter from
  109. examining what's happening on the Mac.
  110.  
  111. CALL XBrowse2Click TO res WITH "D"
  112.  
  113. RETURN VALUES
  114.   0 = OK
  115.  -1 = invalid function switch
  116.  
  117.  
  118. SHAREWARE DETAILS
  119. Godfather Holdings Pty Ltd as trustee for 
  120. The Dent Family Trust
  121. Trading as A.D. Software
  122. Australian Company Number    009 453 007
  123.  
  124. Contact: Andy Dent BSc, MACS
  125. 94 Bermuda Drive, Ballajura  Western Australia 6066
  126. Phone/Fax:        (09) 249 2719
  127. International:    61 9 249 2719
  128. CompuServe:     100033, 3241
  129. Internet:        dent@dialix.oz.au
  130.  
  131. PAYMENT VIA
  132. International Money Orders
  133. Australian dollars cash
  134. Australian bank or personal cheques (made out to A.D. Software)
  135. Visa, Mastercard or Australian Bankcard
  136.  
  137. FEE & UPDATE DETAILS
  138. The fee is $50 Australian (due to our rotten exchange rate this is about $36 US).
  139. Registered users will receive free upgrades with notices mailed (electronically
  140. where possible) of new versions being uploaded, and available on disk for a
  141. nominal shipping fee, on request.
  142.  
  143. OTHER FOXBASE XCMDS
  144. XScrollList (due out mid-August) Provides loading, filing & display of
  145. "arrays" in normal Mac dialogs with usual list handling facilities supporting
  146. arrow keys, type first few letters to jump to an entry etc.
  147. Arrays stored outside of Fox 64kb memory limit and loaded many times
  148. faster than is possible with arrays inside Fox. 
  149. Dialog returns list entry number, record number (optional) and text of entry
  150. selected.
  151. Dialogs are constructed as resources (using Apple's ResEdit) and can have as
  152. many buttons as you like, the name of the button pressed being returned to a
  153. Fox variable.
  154. Multiple selections are also supported, using the standard technique of
  155. shift-click to select a contiguous range or command-click for ad-hoc items.
  156.  
  157. OTHER PRODUCTS & SERVICES
  158. A.D. Software is a custom software development house ╤ if you have any other
  159. XCMD or other programming requirements, please contact me for further information.
  160.  
  161. Major products include a FORTRAN->Pascal translator and multi-user classified
  162. advertisement publishing system.
  163. ---------------------------------------------------------------------------------*/
  164.